home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / cvt2qb11.zip / EXITINFO.DOC < prev    next >
Text File  |  1993-04-17  |  6KB  |  134 lines
  1.  
  2.  
  3.      ███████╗ ██╗  ██╗ ██╗ ████████╗ ██╗ ███╗   ██╗ ███████╗  ██████╗
  4.      ██╔════╝ ╚██╗██╔╝ ██║ ╚══██╔══╝ ██║ ████╗  ██║ ██╔════╝ ██╔═══██╗
  5.      █████╗    ╚███╔╝  ██║    ██║    ██║ ██╔██╗ ██║ █████╗   ██║   ██║
  6.      ██╔══╝    ██╔██╗  ██║    ██║    ██║ ██║╚██╗██║ ██╔══╝   ██║   ██║
  7.      ███████╗ ██╔╝ ██╗ ██║    ██║    ██║ ██║ ╚████║ ██║      ╚██████╔╝
  8.      ╚══════╝ ╚═╝  ╚═╝ ╚═╝    ╚═╝    ╚═╝ ╚═╝  ╚═══╝ ╚═╝       ╚═════╝
  9.  
  10.  
  11.  
  12.                ╒═════════════════════════════════════════════╕
  13.                │                                             │░░
  14.                │ T H E  T A G  TO  Q B B S  E X I T I N F O  │ ░
  15.                │                                             │ ░
  16.                │              G E N E R A T O R              │ ░
  17.                │                                             │ ░
  18.                ╘═════════════════════════════════════════════╛ ░
  19.                     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  20.  
  21.  
  22.  
  23. Acknowledgements
  24. ~~~~~~~~~~~~~~~~
  25.     Thanks got to the TAG team for providing the structure information
  26.     necessary for utility authors to create the utilities that *we* all
  27.     ask for. Thanks especially to Victor Capton and Paul Williams, not only
  28.     for remaining the driving forces behind this special BBS system, but also
  29.     for giving insight  into  TAG's  inner  workings  making this and other
  30.     projects soooooooo much easier to handle.
  31.  
  32.     TAG is copyrighted By The T.A.G. Team
  33.     QuickBbbs (referred to as QBBS) is Copyrighted By Pegasus Software
  34.  
  35.     This program is  copyrighted  by  Rick  Cooper  and  remains  the  sole
  36.     property  of  same.  CVT2QBBS  is  NOT public domain, rather it's to be
  37.     considered freeware.
  38.  
  39. Guarantees/Warranties/And Other Fantasies
  40. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41.     There is no warranty or guarantee offered with this program. The only
  42.     thing I will guarantee is it's ability to take up disk space.
  43.  
  44.     By using this program  you  agree  to  hold  harmless the author in all
  45.     regards and circumstance including but not limited to:
  46.  
  47.         Damage to drives
  48.         Damage to Date
  49.         Loss of income
  50.         Increased Sexual Awareness
  51.         Change of Gender or Species
  52.  
  53.  
  54. Purpose
  55. ~~~~~~~
  56.     EXITINFO.EXE creates the QBBS drop files (version 2.76):
  57.  
  58.         DORINFO?.DEF    : Basic QBBS drop file
  59.         EXITINFO.BBS    : Main, binary User Information Drop File. Usually
  60.                           update buy the applicable door.
  61.         ALIAS   .BBS    : User Handle File (as needed)
  62.         USERS   .BBS    : QBBS user file (as needed)
  63.         USERON .BBS     : Specific User Information (used mainly by
  64.                           Multi-Node  applications)  TAG  generates  an  RA
  65.                           style USERON.BBS file rather than a QBBS version.
  66.  
  67.  
  68.     EXITINFO follows the RA/QBBS 2.76+ DORINFO?.DEF naming conventions. The
  69.     "?" refers to a given node number (Dropped from node2 := DORINFO2.DEF)
  70.     Please Note that not all  doors  will  recognize  anything  other  than
  71.     DORINFO1.DEF..  if  this  is the case for something you are running, or
  72.     you get a  message  stating  the  door  cannot locate DORINFO1.DEF then
  73.     simply add a line to your batch to copy DORINFO?.DEF (what ever  node)
  74.     to  DORINFO1.DEF and that should handle it... Node specific information
  75.     within the EXITINFO.BBS file  will  be  understood and utilized in all
  76.     known cases.
  77.  
  78. Setup/Execution
  79. ~~~~~~~~~~~~~~~
  80.     There is no setup  or  input  files  needed.  EXITINFO  gets  all  it's
  81.     information through the command line via TAG's generic door call.
  82.  
  83.         Pkey    <
  84.         Pdata   (Batch File Name)
  85.  
  86.     The batch file command line would look like:
  87.  
  88.             EXITINFO %1 %2 %3 %4 %5 %6 %7 %8 QBBSDir TAGDir NOOUT CONNECT
  89.  
  90.             %1  :=  Port Speed
  91.             %2  :=  Time left On Line
  92.             %3  :=  User Number
  93.             %4  :=  User First Name
  94.             %5  :=  User Last Name (or "." if none)
  95.             %6  :=  ANSI Status (1 := Yes 0 := No)
  96.             %7  :=  Communications Port (1 based)
  97.             %8  :=  Connect Speed (Different than port Speed When Locked)
  98.  
  99.             QBBSDIr Main QBBS directory for this node (where CVT2QBBS is)
  100.             TAGDir  Main TAG System Directory For This Node
  101.             NOOUT   Optional Switch to suppress User Information Display
  102.             CONNECT Optional switch to have EXITINFO write user connect
  103.                     speed to DORINFO?.DEF rather than the port speed. There
  104.                     are a  few  "brain  dead"  programs  that  will not pay
  105.                     attention to the user connect speed in EXITINFO.BBS and
  106.                     only  use  the  port  speed  in  DORINFO?.DEF..  If  an
  107.                     application is showing or calculating on the port speed
  108.                     then try adding the CONNECT pramater  after  the  paths
  109.                     and see if that doesn't fix it for you.
  110.  
  111.             The Connect  and  NoOut  parameters  can  be  switched back and
  112.             forth, are case insensitive but MUST appear after the paths.
  113.  
  114.             EXITINFO can be executed from any place in your DOS search path
  115.             as it writes it's files to the directory specified as the
  116.             QBBSDir.
  117.  
  118.             If  EXITINFO  finds a user doesn't exist within the QBBS system
  119.             it will notify the  user  and  proceed  to create the USERS.BBS
  120.             file keeping intact any current user records.
  121.  
  122.             Any program requiring ExitInfo.Bbs will effectively operate with
  123.             EXITINFO.EXE
  124.  
  125. If there is a problem
  126. ~~~~~~~~~~~~~~~~~~~~~
  127.  
  128.     I can be contacted via the TAGBETA, TAG, TAGDOORS echos or you can call
  129.     my BBS (Just For The Heck Of  It  II) at (219) 747-5971.. Or netmail me
  130.     at 1:236/16 @FidoNet
  131.  
  132.     Rick Cooper
  133.  
  134.